
2xHexen2: Hammer of Thyrion, GP2X Port
===========================================================================

Hexen II source, and the Hammer of Thyrion source port, are free
but the game itself is not: You must have an original copy of the
game released by Raven Software and Activision.

If possible, I advise you install the portals of praevus mission pack, 
it will improve your fps by about 10% in all areas (aswell as obviously
adding levels & the demoness character).

============================================================================
To Install Hexen 2 On GP2X:

   1. If your data files are not patched to v1.11 apply this patch your 
      hexen 2 PC install:

	http://files.filefront.com/Hexen+II+v111+Patch/;5847;/fileinfo.html

      After verifying your version, copy the "data1" folder (and inclusive 
      files) from your Hexen2 CD or PC install to anywhere on your SD card. 
      
      For Midi Background Music you must have Timidity installed in the 
      same directory as the game, this should add *at least* the following 
      files & folders:

	./instruments/*.*	(lots of .pat files)
	./timidity.cfg 
      
      If you want to apply the same settings (increase performance) as i 
      use copy the "autoexec.cfg" file from the .zip and paste over the 
      config file found in "./data1/autoexec.cfg"
 
   2. Copy the gpe, gpu and mmuhack.o files that came with this readme to the 
      same directory on your SD card. If you want the mission pack "Portals of 
      Praevus" installed copy the "portals" folder from your hexen 2 
      install/CD to the same dir on your SD card. The should result in the 
      following file structure:

	./portals/*.*		(for mission pack support)
	./instruments/*.* 	(for midi support)
	./timidity.cfg		(for midi support)
	./data1/*.*
	./2xHexen2.gpe 
	./2xHexen2.gpu
	./mmuhack.o
   
   3. Run the .gpu on your GP2X. Enjoy.

=============================================================================

Button mapping:
+===============+==============+==============+=================+
|GP2X 		|GAME          |Menu          |Console          |
+===============+==============+==============+=================+
|Joystick Up    |Forward       |Up            |                 |
|Joystick Down  |backwards     |Down          |                 |
|Joystick Left  |Rotate Left   |Left          |                 |
|Joystick Right |Rotate Right  |Right         |                 |
|Button L       |Strafe Left   |Exit          |Exit             |
|Button R       |Strafe Right  |Enter         |Enter            |
|Button A	|Use Item      |N/A           |                 |
|Button B	|Attack        |Enter         |                 |
|Button X	|Crouch        |Exit          |Profiling Info   | 
|Button Y	|Jump          |N/A           |Execute FPS Test | 
|Volume -	|Change Weapon |N/A           |                 |
|Volume +	|Change Item   |N/A           |                 |
|Start		|Open Menu     |N/A           |                 |
|Select	        |Toggle Run    |N/A           |                 |
+===============+==============+==============+=================+

What Hammer of Thyrion Options are Supported/Not Supported:
+===============================+====================================+
|FEATURE	                |STATE                               |
+===============================+====================================+
|Hexen 2 Singleplayer   	|Supported                           |
|Portals Of Praveus Singleplayer|Supported  			     |
|Hexen 2 Demo Singleplayer	|Supported                           |
|Multiplayer		        |Not Supported                       |
|CD Audio		        |Not Supported                       |
|SDL Sound FX		        |Not Supported                       |
|Midi Background Music		|Supported                           |
|Software Rendering	        |Supported                           |
|OpenGL Rendering	        |Not Supported                       |
+===============================+====================================+

Known Issues, that i plan on fixing/improving:
------------------------------------------------------------------------
Shifting Textures: 	Especially ones at a distance, This is due to 
			a fixed point optimisations....
No Sound FX: 		This is because the sound FX implementation 
                        requires direct access to the sound buffer.... 
			this is incompatible with SDL_Mixer. 

Credits: (If i've forgotten someone please contact me.)
------------------------------------------------------------------------
- GP2X Port 		Programmer - Adventus
           		Beta Tester- namco
- Minimal Lib		Rlyeh
- PocketQuake		Dan East
- Linux HoT Port 	Hammer of Thyrion Team.
- Original Developers 	Raven Software and Activision.

Contact:
------------------------------------------------------------------------
Adventus -> lachlan_ts@hotmail.com